备份与恢复配置参数引用
备份与恢复配置参数
这些主题描述了用于 onbar、ontape 和 archecker 实用程序的配置参数。
其中大部分配置参数可在 onconfig 文件中设置。 但是，某些 archecker 配置参数要在 AC_CONFIG 文件中设置。
请务必配置您的存储管理器。根据您选择的存储管理器，可以设置不同的 onbar 配置参数。如果您使用的是第三方存储管理器，那么在启动 onbar 之前请参阅配置第三方存储管理器。
下表描述了每个参数的以下属性（如果相关）。
| 属性 | 描述 |
|---|---|
| ac_config.std 值 | 对于 archecker 配置变量。ac_config.std 文件中显示的缺省值。 |
| onconfig | onconfig 配置变量。onconfig文件中显示的缺省值。 |
| 如果值不存在 | 如果 onconfig 文件缺少该参数，那么数据库服务器将提供该值。 如果该值出现在 onconfig 中，数据库服务器将使用 onconfig 值。 如果 onconfig 中不存在该值，数据库服务器将使用该值。 |
| 单位 | 表示该参数用的单位 |
| 值的范围 | 该参数的有效值 |
| 生效 | 对参数值的更改将影响 onbar 操作的时间。 除非另有指定，否则可以在备份与恢复之间更改参数值。 |
| 引用 | 对进一步讨论的交叉引用 |
onconfig 文件中的 onbar 和 ontape 配置参数
这些主题包含有关 onbar 和 ontape 实用程序配置参数的参考信息
重要： onbar 不使用 TAPEDEV、TAPEBLK、TAPESIZE、LTAPEBLK 和 LTAPESIZE 配置参数。onbar 检查 LTAPEDEV 是否设置为 /dev/null（UNIX™ 上）。
BACKUP_FILTER 配置参数
使用 BACKUP_FILTER 配置参数可指定用于 onbar 或 ontape 实用程序的外部过滤器程序的路径名和任何选项。
onconfig.std 值
未设置。备份数据未过滤。
值
命令的路径名和任何选项。缺省情况下，路径名相对于 $GBASEDBTDIR/bin 目录，否则，路径名必须是程序的绝对路径。 如果您要包括命令行选项，那么必须使用单引号括住过滤器名称和选项。
生效
编辑 onconfig 文件，并且 onbar 或 ontape 启动后。
用途
该过滤器在备份数据之前对其进行变换（例如，将其压缩）。然后变换的数据将被备份，并且会存储成单个文件。执行恢复时，必须将数据变换回其原始格式。在通过设置 RESTORE_FILTER 配置参数进行恢复之前，指定相应程序来变换数据。
为了安全，过滤器不能有非特权用户写许可权。对过滤器的许可权与对 GBase 8s 服务器或实用程序所调用的其他可执行文件的许可权相同。
如果在 onconfig 文件中设置 BACKUP_FILTER 参数，那么 LTAPESIZE 配置参数不能设置为 0。否则，在将逻辑日志备份到磁盘上的目录时，onbar 或ontape 实用程序会返回错误。错误消息为：
当已设置 BACKUP_FILTER 配置参数时，LTAPESIZE 配置
参数无法设置为 0；请更改 LTAPESIZE 的值。
程序结束。
变通方法是将 LTAPESIZE 配置参数设置为高值。日志文件不会大幅高于 LOGSIZE 配置参数。使用 LOGSIZE 中的值作为此数据库的上限。
在 BACKUP_FILTER 配置参数中指定过滤器信息时，请指定过滤器程序的路径名和任何选项，如以下示例中所示：
BACKUP_FILTER /bin/compress
此过滤器所生成的输出将作为单个对象保存到存储管理器中。
BACKUP_FILTER 配置参数可包括命令行选项以及过滤器名称。例如，指定：
BACKUP_FILTER 'my_encrypt -file /var/adm/encryption.pass'
BAR_ACT_LOG 配置参数
使用 BAR_ACT_LOG 配置参数可指定 onbar 活动日志的完整路径名。
onconfig 值
none
值的范围
完整路径名
生效
onbar-driver 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
您应该指定具有适当可用空间量的现有目录的路径，或者使用 $GBASEDBTDIR/bar_act.log。
无论何时有备份或恢复活动发生或者出错，onbar 都会向活动日志写入一条简要说明。文件格式与数据库服务器消息日志的格式相似。可以检查活动日志以确定 onbar 操作的结果。
如果 BAR_ACT_LOG 配置参数指定的文件不存在，那么会创建该文件。如果 onbar 命令（或与 onbar 相关的任何实用程序，如 onsmsync 实用程序）从未在系统上运行，那么该文件不存在。
sysbaract_log 表是从 BAR_ACT_LOG 指定的文件读取数据的系统监视接口伪表。如果尝试在不存在 BAR_ACT_LOG 文件的系统上查询sysbaract_log，那么会返回以下错误：
244：无法执行物理顺序读来访存下一行。
101：ISAM 错误：文件未打开。
仅指定文件名时的用法
如果在 BAR_ACT_LOG 配置参数中仅指定文件名，onbar 将在您启动 onbar 的工作目录中创建 onbar 活动日志。例如：如果您从 UNIX™ 上的 /usr/mydata 启动 onbar，那么会将活动日志写入该目录中。
对于 UNIX™，如果数据库服务器启动连续逻辑日志备份，onbar 会写入该数据库服务器的工作目录中的 onbar 活动日志。
BAR_BSALIB_PATH 配置参数
使用 BAR_BSALIB_PATH 配置参数可为所使用的存储管理器的 XBSA 共享库指定路径名和文件名。
onconfig 值
UNIX™：none
生效
onbar-driver 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
onbar 和存储管理器依靠共享库来彼此结合。请为您的存储管理器库配置 BAR_BSALIB_PATH 配置参数。对 BAR_BSALIB_PATH 的支持特定于平台。请检查您的机器说明，以确定是否可以对您的操作系统使用该配置参数。可以在备份与恢复之间更改 BAR_BSALIB_PATH 的值。
要确保发生这种集成，请指定共享库的路径名。请指定以下选项之一：
UNIX：
-
将存储管理器库放到缺省目录中。
例如，Solaris 的后缀是 so，因此在 Solaris 系统上指定 $GBASEDBTDIR/lib/ibsad001.so。
例如，Solaris 的后缀是 so，因此在 Solaris 系统上指定 $GBASEDBTDIR/lib/libbsapsm.so。
-
将存储管理器库放在任意目录下，并创建一个从 $GBASEDBTDIR/lib/ibsad001.platform_extension 到它的符号链接。
如果您使用 Storage Manager ，那么创建 $GBASEDBTDIR/lib/libbsa.platform_extension 的符号链接或将 BAR_BSALIB_PATH 设置为此绝对路径值。
-
设置 LD_LIBRARY_PATH 环境变量。 例如，将 LD_LIBRARY_PATH 设置为 $GBASEDBTDIR/lib。
如果参数 BAR_BSALIB_PATH 缺失或没有值，并且数据库服务器无法打开您的平台的 XBSA 共享库，那么 ONBAR会尝试使用 GBase 8s 主存储管理器 作为所有平台中的存储管理器。
确保在恢复中共享库可以访问存储管理器中的备份数据。不能备份到一个存储管理器而从其他存储管理器恢复。
BAR_CKPTSEC_TIMEOUT 配置参数
BAR_CKPTSEC_TIMEOUT 配置参数指定在执行外部备份时，RHAC 辅助服务器应等待检查点从主服务器到达的时间量（以秒为单位）。
onconfig 值
15
如果值不存在
15
单位
秒
值的范围
5 到 CKPTINTVL 配置参数值的两倍
生效
编辑 onconfig 文件并重新启动数据库服务器后。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
当在 RHAC 辅助服务器上执行外部备份时，辅助服务器必须等待检查点从主服务器的逻辑日志中到达。检查点会清空缓冲区，将其中的内容保存到磁盘中，并阻塞包含临时表的用户事务。如果主服务器上的检查点在超时时段内未完成，那么 RHAC 辅助服务器上的备份将失败。您可以将 BAR_CKPTSEC_TIMEOUT 配置参数设置为执行外部备份时，RHAC 辅助服务器应等待检查点从主服务器到达的时间量（以秒计）。
BAR_DEBUG 配置参数
使用 BAR_DEBUG 配置参数可指定数据库服务器在 onbar 活动日志中捕获的调试信息量。
onconfig 值
BAR_DEBUG 0
值
0 = 不显示调试信息。
1 = 打印少量信息
2 = 每次 onbar 符合以下条件时打印消息：
- 进入函数。
- 退出函数。该消息包括函数的返回码。
3 = 打印退出和进入信息，以及其他详细信息。
4 = 还打印有关 onbar 并行操作的信息。
5 = 还打印有关以下项的信息：
- 要备份或恢复的对象。
- 与 bar_action 表对应的 act_node 结构。
6 = 打印有关以下项的其他信息：
- 要备份或恢复的对象。
- 与 bar_action 表对应的 act_node 结构。
7 = 还打印：
- 与 bar_instance 表对应的 ins_node 结构的内容相关信息。
- 对 bar_action 表的修改的相关信息。
- 有关恢复的逻辑日志和对象的信息。
- sysutils 数据库上完成的 SQL 语句以及返回的 SQLCODES。
8 = 还打印已归档且已恢复的所有页面的页面标题。 此设置需要大量空间。
9 = 打印以下项的内容：
- 初始化后的 bar_ins 结构。
- 冷恢复的对象描述符。
生效
针对任何当前正在执行的 onbar 命令和任何后续命令编辑 onconfig 文件后立即生效。 当您更新 BAR_DEBUG 时当前正在执行的任何 onbar 命令都会读取 BAR_DEBUG 的新值并以新的级别打印调试消息。
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
缺省值 0 不显示调试信息。将 BAR_DEBUG 配置参数设置为较高值，以在 onbar 活动日志中显示更详细的调试信息。
在会话期间，您可以在 onconfig 文件中动态更新 BAR_DEBUG 的值。
BAR_DEBUG_LOG 配置参数
使用 BAR_DEBUG_LOG 参数可指定 onbar 调试日志的位置和名称。
onconfig 值
/usr/gbasedbt/bar_dbug.log
如果值不存在
UNIX™：/tmp/bar_dbug.log
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
出于安全性原因，请将 BAR_DEBUG_LOG 配置参数设置为带有受限许可权的目录，如 $GBASEDBTDIR 目录。
BAR_HISTORY 配置参数
使用 BAR_HISTORY 配置参数可指定当您使用 onsmsync 使旧备份到期时，sysutils 数据库是否保留备份历史记录。
onconfig.std 值
none
如果值不存在
0
值的范围
0 = 从 sysutils 数据库中除去到期的备份对象的记录
1 = 在 sysutils 数据库中保留到期的备份对象的记录
生效
onsmsync 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
如果将值设置为 0，那么 onsmsync 从 sysutils 数据库中将已到期的备份对象的 bar_object、bar_action 和 bar_instance 行除去。如果将值设置为 1，那么 onsmsync 将 bar_action 行中的 act_type 值设置为 7，并在 sysutils 数据库中为已到期的备份对象保留 bar_action 和 bar_instance 行。如果未将 BAR_HISTORY 设置为 1，那么恢复历史记录将被除去。
不管 BAR_HISTORY 的值是什么，当存储管理器使该对象到期时，onsmsync 都将从紧急引导文件中除去描述备份对象的行并从存储管理器中除去该对象。
有关 onsmsync 的更多信息，请参阅 onsmsync 实用程序。
BAR_IXBAR_PATH 配置参数
使用 BAR_IXBAR_PATH 配置参数来更改 onbar 引导文件的路径和名称。
onconfig 值
UNIX™ 或 Linux™：$GBASEDBTDIR/etc/ixbar.servernum
值的范围
onbar 引导文件的完整路径名
生效
当 onbar 或 onsmsync 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
缺省情况下，将在 UNIX 或 Linux 上的 $GBASEDBTDIR/etc 文件夹中创建 onbar 引导文件。此文件的缺省名称为 ixbar.servernum，其中servernum 是 SERVERNUM 配置参数的值。
例如，对于 SERVERNUM 配置参数等于 41 的情况，在 UNIX 中，缺省情况下将使用此路径和名称创建 onbar 引导文件：
BAR_IXBAR_PATH $GBASEDBTDIR/etc/ixbarboot.41
您可以更改路径以在其他位置中创建该文件。例如，如果要在目录 /usr/gbasedbt 中使用名称 ixbar.new 创建 onbar 引导文件，请指定：
BAR_IXBAR_PATH=/usr/gbasedbt/ixbar.new
BAR_MAX_BACKUP 配置参数
使用 BAR_MAX_BACKUP 参数可指定每个 onbar 命令允许的最大并行进程数。
onconfig 值
0
如果值不存在
4
单位
onbar 进程
值
0 = 系统上允许的最大进程数
1 = 串行备份或恢复
n = 所创建进程的指定数量
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
虽然数据库服务器的 BAR_MAX_BACKUP 缺省值是 4，但 onconfig.std 的值是 0。
UNIX™ 支持并行备份。
指定串行备份与恢复
要执行串行备份或恢复（包括串行的整个系统备份或恢复），请将 BAR_MAX_BACKUP 设置为 1。
指定并行备份与恢复
要指定并行备份与恢复（包括并行的整个系统备份与恢复），请将 BAR_MAX_BACKUP 设置为高于 1 的值。例如，如果将 BAR_MAX_BACKUP 设置为 5 并执行 onbar 命令，那么 onbar 同时创建的最大进程数为 5。BAR_MAX_BACKUP 最大可以配置为与存储设备最大数或物理备份与恢复可用的最大流数相等。onbar 按并行资源有效使用的大小对数据库空间进行分组。
如果将 BAR_MAX_BACKUP 设置为 0，系统将按照需要的数目创建 onbar 进程。onbar 进程的数目只受存储空间的数目或数据库服务器可用内存大小的限制，取两个值中较小的一个。
可用内存大小基于 SHMTOTAL。onbar 执行以下计算，其中 N 是允许执行的 onbar 进程的最大数目：
N = SHMTOTAL / (传送缓冲区数 * 传送缓冲区的大小 / 1024)
如果 SHMTOTAL 是 0，那么 BAR_MAX_BACKUP 将重置为 1。如果 N 大于 BAR_MAX_BACKUP，那么 onbar 将使用 BAR_MAX_BACKUP 的值。否则，onbar 将启动 N 个备份或恢复进程。
BAR_NB_XPORT_COUNT 配置参数
使用 BAR_NB_XPORT_COUNT 配置参数可指定每个 onbar_d 进程可以用来与数据库服务器交换数据的数据缓冲区的数量。
onconfig 值
20
如果值不存在
20
单位
缓冲区
值的范围
3 到无穷大
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
此参数的值将影响 onbar 的性能。例如，如果将 BAR_NB_XPORT_COUNT 设置为 5 并发出 5 个 onbar 命令，那么生成的 25 个 onbar 进程将总共使用 125 个缓冲区。
要计算每个 onbar_d 进程需要的内存大小，请使用以下公式。有关系统的页大小的信息，请参阅发行说明：
required_memory = (BAR_NB_XPORT_COUNT * BAR_XFER_BUF_SIZE * page_size) + 5 MB
BAR_PERFORMANCE 配置参数
使用 BAR_PERFORMANCE 配置参数可指定性能统计信息的类型，以报告至备份与恢复操作的 onbar 活动日志。
onconfig 值
0
单位
统计信息的级别
值
0 = 不收集性能统计信息
1 = 报告在 GBase 8s 实例与存储管理器之间传输数据时所耗用的时间。
2 = 采用活动日志和错误日志中的时间戳记以微秒为单位报告 onbar 处理性能
3 = 报告这两种微秒时间戳记并传输统计信息。
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
例如，如果将 BAR_PERFORMANCE 设置为 3，onbar 将在活动日志中报告 GBase 8s 实例与存储管理器之间传输数据时所耗用的时间。如果将 BAR_PERFORMANCE 设置为 0 或不设置，onbar 将不报告性能统计信息。
- 要关闭性能监视，请将该值设置为 0。这是缺省值。
- 要显示 GBase 8s 实例和存储管理器之间传输数据时所耗用的时间，请将该参数设置为 1。
- 要显示时间戳记（以微秒计），请将该参数设置为 2。
- 要显示时间戳记和传输统计信息，请将该参数设置为 3。
BAR_PROGRESS_FREQ 配置参数
使用 BAR_PROGRESS_FREQ 配置参数可指定 onbar 活动日志中出现备份与恢复操作的进度消息的频率（以分钟为单位）。
onconfig 值
0
如果值不存在
0
单位
分钟
值的范围
0，然后是 5 到无穷大
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
示例：如果将 BAR_PROGRESS_FREQ 设置为 5，那么 onbar 每 5 分钟报告一次该对象的已备份或恢复的百分比。 如果将 BAR_PROGRESS_FREQ 设置为 0 或不设置该参数，那么 onbar 不将任何进度消息写入到活动日志中。
指定一个大于等于 5 分钟的值。请不要将 BAR_PROGRESS_FREQ 设置为 1、2、3 或 4，onbar 会将其自动重置到 5 以防止 onbar 活动日志溢出。
如果 onbar 无法确定备份或恢复对象的大小，它将报告发送到数据库服务器的传送缓冲区数，而不是报告对象已备份或恢复的百分比。
BAR_RETRY 配置参数
使用 BAR_RETRY 配置参数可指定如果第一次尝试失败，onbar 应该尝试数据备份、逻辑日志备份或恢复操作的次数。
onconfig 值
1
如果值不存在
1
单位
整数
值的范围
0 = BAR_ABORT，停止备份/恢复的其余部分
1 = BAR_CONT，继续备份/恢复的其余部分
n = 2 到 32766
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
BAR_RETRY 参数的设置按照以下方式确定 onbar 的行为：
- 如果设置为 0 (BAR_ABORT)，那么在存储空间或逻辑日志出错时，onbar 将停止备份或恢复会话，返回错误并退出。如果 onbar 以并行方式运行，那么已经运行的进程将结束但是不启动新进程。
- 如果设置为 1 (BAR_CONT)，那么 onbar 将对该特定存储空间停止备份或恢复尝试，返回错误，并尝试备份或恢复任何剩余的存储空间或逻辑日志。
- 如果设置为具体数字（重试备份与恢复操作 2 到 32766 次），那么 onbar 将尝试备份或恢复该存储空间或逻辑日志指定次数，然后放弃尝试并继续到下一个存储空间或逻辑日志。
BAR_SIZE_FACTOR 配置参数
在备份之前，使用 BAR_SIZE_FACTOR 配置参数来提高备份对象大小的估计值。
onconfig 值
0
值的范围
正整数
生效
数据库服务器启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
此估计值在备份之前进行处理，并以特定方式进行计算，以便存储管理器可以相应分配存储介质。由于备份是联机进行的，因此要备份的页数可能会在备份过程中发生变化。一些存储管理器非常严格，如果备份估计值过低，备份会出现错误。
在将 BAR_SIZE_FACTOR 值传达到存储管理器前，BAR_SIZE_FACTOR 被视为是原有备份对象大小的百分比加上估计值。BAR_SIZE_FACTOR 只用于数据库空间备份对象，不用于逻辑日志备份对象。
计算新的估计备份对象大小的公式为：
new_estimate = original_estimate x (1 + (BAR_SIZE_FACTOR / 100))
在特定服务器环境中将此参数设为何值取决于在备份或归档期间系统上的活动。因此，要确定值的大小需要根据个人对该系统的经验而论。
BAR_XFER_BUF_SIZE 配置参数
使用 BAR_XFER_BUF_SIZE 配置参数可指定每个传输缓冲区的大小。
onconfig 值
31（如果 PAGESIZE 是 2 千字节）
15（如果页面大小是 4 千字节）
单位
页数
ONBAR与 GBase 8s 主存储管理器 一起使用时的值的范围
1 - 32768
BAR_XFER_BUF_SIZE 的值以 GBase 8s 基页大小为单位。对于 Linux、Solaris 和 HP，GBase 8s 基页大小为 2K。
1 - 15 个页面（当 PAGESIZE 是 4 千字节时）
1 - 31 个页面（当 PAGESIZE 是 2 千字节时）
最大缓冲区大小是 64 千字节，因此 BAR_XFER_BUF_SIZE * 页面大小 <= 64 千字节。
ONBAR与其他存储管理器一起使用时的值的范围
1 - 15（如果 GBase 8s 基页大小为 4 千字节）
1 - 31（如果 GBase 8s 基页大小为 2 千字节）
最大缓冲区大小是 64 千字节，因此 BAR_XFER_BUF_SIZE * 页面大小 <= 64 千字节。
生效
onbar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值时。
用途
数据库服务器将缓冲区传递到 onbar 和存储管理器。
要计算存储空间或逻辑日志备份中传输缓冲区的大小，请使用以下公式：
一个传输缓冲区大小 = BAR_XFER_BUF_SIZE * 基页 pagesize
要计算数据库服务器对于每个传输缓冲区需要多少内存，请使用以下公式：
内存 = (BAR_XFER_BUF_SIZE * 基页 PAGESIZE) + 500
额外的 500 字节是系统开销。例如，如果 BAR_XFER_BUF_SIZE 为 15，那么传输缓冲区应该为 61,940 字节。
传输缓冲区的数量（针对每个备份流）由 BAR_NB_XPORT_COUNT 指定，而并行备份流的数量由 BAR_MAX_BACKUP 指定。
不能在备份与恢复之间更改缓冲区的大小。AC_TAPEBLOCK 和 AC_LTAPEBLOCK 的值需要与归档时的 BAR_XFER_BUF_SIZE 值相同。
例如，对于 Linux 上大小为 128*2048（值为 262144）的传输缓冲区，请指定：
BAR_XFER_BUF_SIZE 128
ISM_DATA_POOL 配置参数
ISM_DATA_POOL 配置参数（当在数据库服务器的 onconfig 文件中列出时）指定用于备份存储空间的卷池。
onconfig 值
ISMData
生效
onbar 启动时
用途
该参数的值可以是 Storage Manager 识别的任意卷池。如果此参数不存在，那么 Storage Manager 使用 ISMData 卷池。有关详细信息，请参阅《GBase 8s Storage Manager 管理员指南》。
ISM_LOG_POOL 配置参数
ISM_LOG_POOL 参数（当在数据库服务器的 onconfig 文件中列出时）指定用于备份逻辑日志的卷池。
onconfig 值
ISMLogs
生效
onbar 启动时
用途
该参数的值可以是 Storage Manager 识别的任意卷池。如果此参数不存在，那么 ISM 使用 ISMLogs 卷池。有关详细信息，请参阅《GBase 8s Storage Manager 管理员指南》。
LTAPEBLK 配置参数
使用 LTAPEBLK 配置参数可指定当使用 ontape 进行数据库空间备份时将逻辑日志备份到的设备的块大小。
LTAPEBLK 还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备的块大小。如果要使用 onload 或 onunload，那么可以在命令行中指定不同的块大小。
onconfig 值
在 UNIX™ 上：32
单位
千字节
值的范围
大于 (页面大小/1024) 的值
要获取页面大小，请运行 onstat -b 命令。
生效
对于 ontape：
- 当您执行 ontape 时。
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
将 LTAPEBLK 指定为磁带设备所允许的最大块大小。当您指定块大小时，数据库服务器不检查磁带设备。验证 LTAPEDEV 磁带设备是否可以读取所指定的块大小。如果不能，您可能无法读取磁带。
仅限 UNIX：UNIX dd 实用程序可以验证 LTAPEDEV 磁带设备是否可以读取块大小。大多数 UNIX 系统都提供了该实用程序。
如果指定 LTAPEBLK 值，那么 onbar 将忽略该值。
LTAPEDEV 配置参数
使用 LTAPEDEV 配置参数可指定当使用 ontape 进行备份时将逻辑日志备份到的设备或目录文件系统。
LTAPEDEV 配置参数还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备。如果要使用 LTAPEDEV 指定用于 onunload 或 onload 的设备，那么 TAPEDEV 的相同信息对于 LTAPEDEV 也相关。
onconfig 值
在 UNIX™ 上：/dev/tapedev
如果不存在
在 UNIX 上：/dev/null
生效
对于 ontape：
- 当执行 ontape 时，设置为磁带设备的情况下。
- 当数据库服务器关闭并重新启动时，在 UNIX 上设置为 /dev/null 的情况下。
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
- 通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
当您使用 onbar 备份逻辑日志时，请勿将 LTAPEDEV 设置为 /dev/null 或 nul。
如果在 LTAPEDEV 配置参数中指定磁带设备，那么 onbar 将忽略该值。
仅当不需要备份逻辑日志时，才将 LTAPEDEV 设置为 /dev/null 或保留为空白（UNIX 上）。将 LTAPEDEV 的值更改为 /dev/null 之前，必须使数据库服务器处于脱机状态。
当您将 LTAPEDEV 设置为 /dev/null 时：
- 数据库服务器将释放逻辑日志，而不要求您备份这些日志。虽然逻辑日志未被标记为已释放，但数据库服务器可以重用它们。
- onbar 活动日志将显示警告和返回码 152。由于数据库服务器把不再是当前的逻辑日志标记为已备份的日志，所以 onbar 找不到要备份的逻辑日志。那些日志中的所有事务都将丢失，并且无法恢复。
如果在 LTAPEDEV 设置为空 (null) 的情况下执行整个系统的备份，必须在恢复期间使用 onbar -r -w -p 命令通知 onbar 不需要恢复日志。.
LTAPESIZE 配置参数
使用 LTAPESIZE 配置参数可指定当使用 ontape 进行备份时将逻辑日志备份到的设备的最大磁带大小。
LTAPESIZE 配置参数还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备的最大磁带大小。如果要使用 onload 或onunload，那么可以在命令行上指定不同的磁带大小。如果要使用磁带的全部容量，请将 LTAPESIZE 设置为 0。
onconfig 值
0
单位
千字节
值的范围
0 或任何正数。真实值依赖于操作系统。
生效
对于 ontape：
- 当您执行 ontape 时。
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
LTAPESIZE 指定当使用 ontape 进行备份时将逻辑日志备份到的设备的最大磁带大小。LTAPESIZE 还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备的最大磁带大小。如果要使用 onload 或 onunload，那么可以在命令行上指定不同的磁带大小。如果要使用磁带的全部容量，请将 LTAPESIZE 设置为 0。
如果在 ONCONFIG 文件中设置 BACKUP_FILTER 参数，那么 LTAPESIZE 无法设置为 0。否则，在将逻辑日志备份到磁盘上的目录时，ontape 实用程序会返回错误。错误消息为：
当已设置 BACKUP_FILTER 配置参数时，LTAPESIZE 配置
参数无法设置为 0；请更改 LTAPESIZE 的值。
程序结束。
变通方法是将 LTAPESIZE 配置参数设置为非常高的值。日志文件不会大幅高于 LOGSIZE 配置参数。使用 LOGSIZE 中的值作为此数据库的上限。
如果指定 LTAPESIZE 值，那么 onbar 将忽略该值。
RESTARTABLE_RESTORE 配置参数
使用 RESTARTABLE_RESTORE 配置参数来启动或禁用可重新开始的恢复。
onconfig 值
RESTARTABLE_RESTORE ON
值
禁用
禁用可重新开始的恢复。如果恢复失败并且 RESTARTABLE_RESTORE 为 OFF，那么您无法重新启动该恢复。
启用
启用可重新开始的恢复。开始恢复前将 RESTARTABLE_RESTORE 设置为 ON。否则，您将无法在失败后重新启动恢复。
生效
编辑 onconfig 文件后。如果需要重新启动物理恢复，那么不需要在可以使用 RESTARTABLE_RESTORE 之前重新启动数据库服务器。 如果需要重新启动逻辑恢复，那么必须在使用可重新开始的恢复前重新启动数据库服务器。
打开 RESTARTABLE_RESTORE 将降低逻辑恢复的性能。有关更多信息，请参阅 onbar -RESTART 语法：重新启动失败的恢复。
RESTORE_FILTER 配置参数
使用 RESTORE_FILTER 配置参数可指定过滤器程序的路径名以及任何选项。
onconfig 值
未设置。恢复的数据未过滤。
值
命令的路径名和任何选项。缺省情况下，路径名相对于 $GBASEDBTDIR/bin 目录，否则，路径名必须是程序的绝对路径。 如果您要包括命令行选项，那么必须使用单引号括住过滤器名称和选项。
生效
编辑 onconfig 文件，并且 onbar 或 ontape 启动后。
用途
此过滤器在恢复之前，将备份期间变换的数据变换至其原始格式。 RESTORE_FILTER 配置参数指定的过滤器必须与 BACKUP_FILTER 配置参数指定的过滤器相匹配。例如，如果在备份期间压缩了数据，那么必须在恢复期间解压缩该数据。
为了安全，过滤器不能有非特权用户写许可权。该过滤器的许可权与 GBase 8s 服务器或实用程序所调用的其他可执行文件的许可权相同。
例如，如果您要压缩备份的数据，可以将 BACKUP_FILTER 和 RESTORE_FILTER 配置参数设置为以下值：
BACKUP_FILTER /bin/compress
RESTORE_FILTER /bin/uncompress
RESTORE_FILTER 配置参数可包括命令行选项以及过滤器名称。例如，指定：
RESTORE_FILTER ‘my_decrypt –file /var/adm/encryption.pass'
在此示例中，引号中的命令用作过滤器。
TAPEBLK 配置参数
使用 TAPEBLK 配置参数可指定 ontape 在存储空间备份期间所写入的设备的块大小。
onconfig 值
在 UNIX™ 上：32
单位
千字节
值的范围
大于 页面大小/1024 的值
要获取页面大小，请运行 onstat -b 命令。
生效
对于 ontape：
- 当您执行 ontape 时。
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
- 通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
TAPEBLK 还指定了当使用 onload 或 onunload 实用程序时将数据装入或卸载到的设备的缺省块大小。如果要使用 onload 或 onunload，那么可以在命令行上指定不同的块大小。
当您指定块大小时，数据库服务器不检查磁带设备。验证 TAPEBLK 磁带设备是否可以读取您所指定的块大小。如果不能，您可能无法读取磁带。
如果指定 TAPEBLK 值，那么 onbar 将忽略该值。
TAPEDEV 配置参数
使用 TAPEDEV 配置参数可指定 ontape 实用程序将存储空间备份到的设备或目录文件系统。
onconfig 值
在 UNIX™ 上：/dev/tapedev
如果不存在
在 UNIX 上：/dev/null
单位
路径名
生效
对于 ontape 实用程序：
- 如果在 UNIX 上设置为 /dev/null ，那么当数据库服务器关闭并重新启动时
- 如果设置为磁带设备，那么当您运行 ontape 实用程序时
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
- 通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload 实用程序：当数据库服务器关闭并重新启动时
用途
开始处理时，ontape 实用程序读取 TAPEDEV 参数的值。如果您将 TAPEDEV 设置为 /dev/null，必须在启动 ontape 以请求备份之前进行此设置。当您将 TAPEDEV 设置为 /dev/null 并请求备份时，数据库服务器将忽略该备份，但仍使用新的备份时间戳记更新数据库空间。
您可以将 TAPEDEV 配置参数设置为 STDIO，以指示 ontape 实用程序对标准 I/O 而不是设备执行备份与恢复操作。
TAPEDEV 配置参数还指定了当使用 onload 或 onunload 实用程序时将数据装入或卸载到的缺省设备。 但是，如果 TAPEDEV 设置为 STDIO，那么 onunload 实用程序将无法卸载数据。
如果更改磁带设备，请验证新设备的 TAPEBLK 和 TAPESIZE 配置参数值是否正确。
如果指定 TAPEDEV 值，那么 onbar 将忽略该值。
远程设备 (UNIX)
在网络中执行存储空间备份时，可以备份到与 UNIX 和 Linux™ 平台上另一个主机相连的远程设备。远程设备和数据库服务器计算机必须具有信任关系，以便 rsh 或 rlogin 实用程序从数据库服务器计算机连接到远程设备计算机，而无需询问密码。您可以通过在远程设备计算机上配置/etc/hosts.equiv 文件、用户的 ~/.rhosts 文件或您系统的任何等效机制，从而建立信任关系。如果想要使用您的平台所使用的缺省实用程序之外的其他实用程序来处理远程会话，那么可以将 DBREMOTECMD 环境变量设置为要使用的特定实用程序。
远程设备的符号链接 (UNIX)
TAPEDEV 配置参数可以是符号链接，从而允许您在磁带设备之间切换，而不必更改 TAPEDEV 配置参数指定的路径名。
请使用以下语法指定连接到另一台主机上的磁带设备：
host_machine_name:tape_device_pathname
以下示例指定主机 kyoto 上的磁带设备：
kyoto:/dev/rmt01
打开前和关闭时将磁带设备倒带
TAPEDEV 配置参数指定的磁带设备必须在其打开前和关闭时执行倒带。数据库服务器要求执行该操作，因为它在写入磁带之前要执行一系列检查。
当数据库服务器尝试写入多卷数据库空间或逻辑日志备份中第一盒磁带之外的任何磁带时，数据库服务器首先读取磁带头以确保该磁带可供使用。然后设备将关闭并重新打开。数据库服务器假定磁带在关闭时已倒带，然后数据库服务器开始写入。
每当数据库服务器尝试读取磁带时，它首先读取头并查找正确的信息。在写入过程中，如果磁带设备未在关闭时倒带，那么数据库服务器在磁带开头处将找不到正确的头信息。
TAPESIZE 配置参数
使用 TAPESIZE 参数指定 ontape 将存储空间备份到的设备的大小。
onconfig 值
0
单位
千字节
值的范围
0 或任何正数。真实值依赖于操作系统。
生效
对于 ontape：
- 当您执行 ontape 时。
- 通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
- 通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
TAPESIZE 还指定使用 onload 或 onunload 时将数据装入或卸载到的缺省设备的大小。如果要使用 onload 或 onunload，那么可以在命令行上指定不同的磁带大小。如果要使用磁带的全部物理容量，请将 TAPESIZE 设置为 0。
如果 TAPEDEV 设置为 STDIO，那么将与磁带大小无关。
如果指定 TAPESIZE 值，那么 onbar 将忽略该值。
archecker 实用程序配置参数和环境变量
这些主题描述了 AC_CONFIG 环境变量和用于 archecker 实用程序的配置参数。
archecker 实用程序使用 ac_config.std 模板中的配置参数来验证备份或执行表级别恢复。如果需要更改这些参数，请将 ac_config.std 模板复制到 AC_CONFIG 文件。AC_CONFIG 环境变量指定了 AC_CONFIG 文件的位置。
由于 onbar 调用 archecker 实用程序来验证备份，因此必须配置 archecker 环境变量和参数，然后才能使用 onbar -v 选项。
您也可以使用在 ac_config.std 文件中没有缺省值，但在该文件中有效的其他 archecker 配置参数。
表 1. archecker 实用程序使用的配置参数
| 配置参数 | 描述 |
|---|---|
| AC_DEBUG | 在 archecker 消息日志中打印调试消息。 |
| AC_IXBAR | 指定 IXBAR 文件的路径名。 如果未在 ac_config 文件中设置，将使用 BAR_IXBAR_PATH 配置参数的值。 |
| AC_LTAPEBLOCK | 指定用于读取逻辑日志的 ontape 块大小。 如果未在 ac_config 文件中设置，将使用 LTAPEBLOCK 配置参数的值。 |
| AC_LTAPEDEV | 指定 ontape 用于读取逻辑日志的本地设备名。 如果未在 ac_config 文件中设置，将使用 LTAPEDEV 配置参数的值。 |
| AC_MSGPATH | 指定 archecker 消息日志的位置。 该配置参数位于缺省 ac_config 文件中。 |
| AC_SCHEMA | 指定 archecker 模式命令文件的路径名。 |
| AC_STORAGE | 指定 archecker 构建的临时文件的位置。 该配置参数位于缺省 ac_config 文件中。 |
| AC_TAPEBLOCK | 指定磁带的块大小（以千字节为单位）。 如果未在 ac_config 文件中设置，将使用 TAPEBLOCK 配置参数的值。 |
| AC_TAPEDEV | 指定 ontape 实用程序使用的本地设备名。 如果未在 ac_config 文件中设置，将使用 TAPEDEV 配置参数的值。 |
| AC_TIMEOUT | 如果 onbar 和 archecker 进程之一过早退出，请为它们指定超时值。 |
| AC_VERBOSE | 为 archecker 消息指定详细或简洁方式。 该配置参数位于缺省 ac_config 文件中。 |
| BAR_BSALIB_PATH | 与 onconfig.std 文件中的 BAR_BSALIB_PATH 服务器配置参数相同。 有关更多信息，请参阅 BAR_BSALIB_PATH 配置参数。 |
如果使用 ontape 实用程序，并且 AC_TAPEDEV、AC_TAPEBLK、AC_LTAPEDEV 和 AC_LTAPEBLK 配置参数未在 AC_CONFIG 文件中设置，那么 archecker 实用程序将使用 onconfig 文件中指定的 TAPEDEV、TAPEBLK、LTAPEDEV、LTAPEBLK 配置参数所指定的值。
AC_CONFIG 文件环境变量
将 AC_CONFIG 环境变量设置为 archecker 配置文件（ac_config.std 或用户定义）的完整路径名。
缺省值
UNIX™：$GBASEDBTDIR/etc/ac_config.std
生效
onbar 启动时
以下是有效的 AC_CONFIG 路径名的示例：
UNIX：/usr/gbasedbt/etc/ac_config.std 和 /usr/local/my_ac_config.std
如果未设置 AC_CONFIG，那么 archecker 实用程序会将 archecker 配置文件的缺省位置设置为 UNIX 上的$GBASEDBTDIR/etc/ac_config.std。
如果未在 AC_CONFIG 文件中指定包括配置文件名的完整路径，那么 archecker 实用程序可能无法正确工作。
AC_DEBUG 配置参数
AC_DEBUG 配置参数使调试消息打印在 archecker 消息文件中。 仅在技术支持指导下使用该参数。
使用该配置参数可能导致 archecker 消息日志文件增长得非常大，并可能显著减慢 archecker 处理的速度。
缺省值
禁用
范围
1-16
AC_IXBAR 配置参数
使用 AC_IXBAR 配置参数可指定 IXBAR 文件的位置。
缺省值
无
范围
任何有效的路径名
AC_LTAPEBLOCK 配置参数
使用 AC_LTAPEBLOCK 配置参数可指定用于读取逻辑日志的 ontape 块大小。
缺省值
32 千字节
范围
0 - 2,000,000,000
用途
当使用以下命令执行归档时：
- onbar -b，AC_TAPEBLOCK 的值应为 BAR_XFER_BUF_SIZE 配置参数值乘以当前页面大小的结果。有关更多信息，请参阅 BAR_XFER_BUF_SIZE 配置参数。
- ontape -t，AC_LTAPEBLOCK 的值应为归档时 TAPEBLK ONCONFIG 配置参数设置为的值。有关更多信息，请参阅指定磁带块大小。
AC_LTAPEDEV 参数
使用 AC_LTAPEDEV 配置参数可指定 ontape 实用程序使用的本地设备名。
如果磁带设备设置为 STDIO，archecker 将从标准输入接收输入。
缺省值
无
范围
任何有效路径名或 STDIO
AC_MSGPATH 配置参数
使用 AC_CONFIG 文件中的 AC_MSGPATH 参数可指定 archecker 消息日志 (ac_msg.log) 的位置。
ac_config.std 值
UNIX™：AC_MSGPATH /tmp/ac_msg.log
生效
onbar 启动时
用途
必须在 AC_CONFIG 文件中指定消息日志的完整路径，否则 archecker 实用程序将无法正确工作。
当您使用 onbar -v 验证备份时，archecker 实用程序将摘要消息 写入到 bar_act.log 中并指示验证是成功还是失败。它将详细消息写入到 ac_msg.log 中。 如果备份验证失败，请放弃该备份并尝试其他备份，或将 ac_msg.log 提供给 GBase 软件支持。有关样本消息，请参阅onbar -v 语法：验证备份。
AC_SCHEMA 配置参数
使用 AC_SCHEMA 配置参数可指定 archecker 模式命令文件的路径名。
缺省值
无
范围
任何有效的路径名
-f cmdfile 命令行选项会覆盖该配置参数。
AC_STORAGE 配置参数
使用 AC_CONFIG 文件中的 AC_STORAGE 配置参数可指定 archecker 存储其临时文件的目录的位置。
ac_config.std 值
UNIX™：/tmp
生效
onbar 启动时
用途
您必须在 AC_CONFIG 文件中指定存储位置的完整路径，否则 archecker 实用程序可能无法正确工作。
下表列出了 archecker 构建的目录和文件。如果验证成功，这些文件将被删除。
表 1. archecker 临时文件
| 目录 | 文件 |
|---|---|
| CHUNK_BM | 每个已备份的存储空间的位图信息。 |
| 信息 | 备份的统计分析和调试信息。 |
| 保存 | PT.######## 文件中的分区页。 FL.######## 文件中的可用块页。 RS.######## 文件中的保留页。 BF.######## 文件中的可用 Blob 映射页 |
要计算所需要的可用空间大小，请参阅用于备份验证的临时空间。建议您将 AC_STORAGE 设置为具有足够可用空间的位置。
AC_TAPEBLOCK 配置参数
使用 AC_TAPEBLOCK 配置参数可在使用 onbar -b 命令或 ontape -t 命令执行归档时指定磁带块的大小（以千字节为单位）。
缺省值
32 千字节
范围
0 - 2,000,000,000
用途
当使用以下命令执行归档时：
- onbar -b，AC_TAPEBLOCK 的值应为 BAR_XFER_BUF_SIZE 配置参数值乘以当前页面大小的结果。有关更多信息，请参阅 BAR_XFER_BUF_SIZE 配置参数。
- ontape -t，AC_LTAPEBLOCK 的值应为归档时 TAPEBLK ONCONFIG 配置参数设置为的值。有关更多信息，请参阅指定磁带块大小。
AC_TAPEDEV 配置参数
使用 AC_TAPEDEV 配置参数可指定 ontape 实用程序使用的本地设备名。
如果磁带设备设置为 STDIO，archecker 将从标准输入接收输入。
缺省值
无
范围
任何有效路径名或 STDIO
AC_TIMEOUT 配置参数
如果 onbar 和 archecker 进程之一过早退出，请使用 AC_TIMEOUT 配置参数为它们指定超时值。
ac_config.std 值
UNIX™：300
单位
秒
生效
当 onbar-v 命令启动时
引入了 AC_TIMEOUT 配置参数以在 onbar 和 archecker 进程之一过早退出时避免它们无限期地互相等待，从而避免在数据服务器初始化期间创建孤立的 zombie 进程。
AC_VERBOSE 配置参数
使用 AC_CONFIG 文件中的 AC_VERBOSE 参数可指定 archecker 消息日志 (ac_msg.log) 中是详细输出还是简洁输出。
ac_config.std 值
1
值的范围
1 = ac_msg.log 中的详细消息
0 = ac_msg.log 中的简洁消息
生效
onbar 启动时
GBase 8s 主存储管理器 配置参数
GBase 8s 主存储管理器 使用某些特定配置参数中的信息。
PSM_ACT_LOG 配置参数
如果您不希望在 onbar 活动日志中包含日志信息，那么可以使用 PSM_ACT_LOG 配置参数指定 GBase 8s 主存储管理器 活动日志的位置。
onconfig 值
none
如果值不存在
将使用 BAR_ACT_LOG 配置参数的值
值的范围
完整路径名
生效
当 onpsm 实用程序启动时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
指定具有适当可用空间量的现有目录的路径，或者使用 $GBASEDBTDIR/psm_act.log。如果仅指定文件名，那么存储管理器将在您启动存储管理器的工作目录中创建活动日志。
如果 PSM_ACT_LOG 配置参数未设置，那么 GBase 8s 主存储管理器 会将活动信息放入 BAR_ACT_LOG 配置参数中指定的目录内。要清楚地将 onbar 与 GBase 8s 主存储管理器 活动信息区分开，请使用 PSM_ACT_LOG 来为存储管理器的活动日志指定不同的位置。
文件格式与数据库服务器消息日志的格式相似。可以检查活动日志以确定存储管理器操作的结果。
如果 PSM_ACT_LOG 配置参数指定的文件不存在，那么会创建该文件。
您也可以使用 PSM_ACT_LOG 环境变量来指定您环境（例如，单个会话）的 GBase 8s 主存储管理器 活动日志的位置。
PSM_CATALOG_PATH 配置参数
使用 PSM_CATALOG_PATH 配置参数可指定包含 GBase 8s 主存储管理器 目录表的目录的完整路径。这些目录表包含有关存储管理器所管理的池、设备和对象的信息。
onconfig 值
UNIX™ 或 Linux™：$GBASEDBTDIR/etc/psm
值的范围
包含 GBase 8s 主存储管理器 目录表的目录的完整路径名
生效
当 onbar 或 onpsm 实用程序启动时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
您可以将缺省路径更改为其他位置。GBase 8s 主存储管理器 会将包含有关设备和对象的信息的文件放在您指定的任何目录中。
如果将备份文件移至其他位置，请更改 PSM_CATALOG_PATH 配置参数的值。
您可以随时备份该文件的内容。
如果您有多个实例，并且每个实例中的 PSM_CATALOG_PATH 都设置为相同的路径，那么所有实例都包含相同的目录表。 可以为每个实例指定不同的路径。
当您首次运行 onpsm 实用程序命令或首次使用 XBSA 共享库时，存储管理器会自动创建目录表。
您也可以使用 PSM_CATALOG_PATH 环境变量来指定您环境（例如，单个会话）的 GBase 8s 主存储管理器 目录表的位置。
PSM_DBS_POOL 配置参数
使用 PSM_DBS_POOL 配置参数可更改 GBase 8s 主存储管理器 用于放置备份与恢复数据库空间数据的池的名称。
onconfig 值
DBSPOOL
生效
当 onpsm 实用程序启动时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
存储管理器会自动将数据库空间数据放入 DBSPOOL 或您指定的池内。您可以使用字母和数字的任意组合。
也可以使用 PSM_DBS_POOL 环境变量来更改您环境（例如，单个会话）的池的名称。
PSM_DEBUG 配置参数
如果您要使用的调试级别不同于 onbar 所使用的级别，请使用 PSM_DEBUG 配置参数指定在 GBase 8s 主存储管理器 调试日志中打印的调试信息量。
onconfig 值
0
单位
一位数字，代表所需的调试信息的级别
值的范围
0 = 无调试消息。
1 = 仅打印内部错误。
2 = 打印有关函数入口和出口的信息，并打印内部错误。
3 = 打印 1-2 指定的信息以及其他详细信息。
4 = 打印有关并行操作的信息，以及 1-3 指定的信息。
5 = 打印有关 GBase 8s 主存储管理器 中内部状态的信息。
6 = 打印 1-5 指定的信息以及其他详细信息。
7 = 打印 1-6 指定的信息以及其他详细信息。
8 = 打印 1-7 指定的信息以及其他详细信息。
9 = 打印所有调试信息。
如果值不存在
将使用 BAR_DEBUG 配置参数的值。
生效
当 onpsm 实用程序启动时
当 onbar 实用程序执行命令并读取 BAR_DEBUG 配置参数中指定的信息时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
如果将 PSM_DEBUG 配置参数设置为大于 0 的有效值，那么 GBase 8s 主存储管理器 会将调试消息记录到其调试日志中。
您可以使用不同的调试值进行试验，以找出合适的信息量。通常，如果 PSM_DEBUG 配置参数设置为 5，存储管理器即可打印足够的信息用于跟踪和调试。
设置为 8 和 9 需要大量空间。
您也可以使用 PSM_DEBUG 环境变量来指定您环境（例如，单个会话）的存储管理器调试日志中打印的调试信息量。
PSM_DEBUG_LOG 配置参数
如果您不希望在 onbar 调试日志中包含日志信息，那么可以使用 PSM_DEBUG_LOG 配置参数指定 GBase 8s 主存储管理器 将调试消息写入的调试日志的位置。
onconfig 值
UNIX™ 或 Linux™：/usr/gbasedbt/bar_dbug.log
如果值不存在
将使用 BAR_DEBUG_LOG 配置参数的值。
生效
当 onpsm 实用程序启动时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
如果 PSM_DEBUG_LOG 配置参数未设置，那么 GBase 8s 主存储管理器 会将活动信息放入 BAR_DEBUG_LOG 配置参数中指定的目录内。要清楚地将 onbar 与 GBase 8s 主存储管理器 活动信息区分开，请使用 PSM_DEBUG_LOG 来为 GBase 8s 主存储管理器 活动日志指定不同的位置。
出于安全性原因，请将 PSM_DEBUG_LOG 配置参数设置为带有受限许可权的目录，如 $GBASEDBTDIR 目录。
如果保留调试文件的目录变得太大，那么您可以擦除该文件。仅当有问题需要调试时，才需要保留信息。
您也可以使用 PSM_DEBUG_LOG 环境变量来指定您环境（例如，单个会话）的调试日志的位置。
PSM_LOG_POOL 配置参数
使用 PSM_LOG_POOL 配置参数可更改 GBase 8s 主存储管理器 用于放置备份与恢复日志数据的池的名称。
onconfig 值
LOGPOOL
生效
当 onpsm 实用程序启动时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
存储管理器会自动将日志数据放入 LOGPOOL 或您指定的池内。您可以使用字母和数字的任意组合。
也可以使用 PSM_LOG_POOL 环境变量来更改您环境（例如，单个会话）的池的名称。
事件警报配置参数
当您设置用于 onbar 和 ontape 实用程序的配置参数时，还要确定是否需要调整 ALARMPROGRAM 和 ALRM_ALL_EVENTS 配置参数。
使用 ALARMPROGRAM 配置参数可将 log_full.sh 脚本设置为在日志文件变满时自动对其进行备份。
使用 ALRM_ALL_EVENTS 配置参数可使 ALARMPROGRAM 在每次调用警报事件时执行。